home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / ramail32.zip / RAMCONF.DOC < prev    next >
Text File  |  1992-07-06  |  10KB  |  180 lines
  1.  
  2.  
  3.                            RAMail Configuration v1.5
  4.                     Copyright 1990-1992 by Randy Blackmond
  5.                               All Rights Reserved
  6.  
  7.      RAMCONF is the configuration program for RAMail. Until version 3.0 of
  8.      RAMail, RAMCONF never had any real documentation because I felt that
  9.      it was straightforward enough not to need it. I still feel this way,
  10.      but being the programmer, things that seem perfectly clear to me may
  11.      be confusing to someone else. This file is provided for those people who
  12.      may need clarification on some of the items in the RAMCONF program.
  13.  
  14.      First, I'll offer a little general information on moving around the
  15.      screen among the different fields. There are three ways to move from
  16.      field to field. These are the ENTER key, the TAB key and the cursor
  17.      keys.
  18.  
  19.      Pressing the ENTER or TAB key will move to the next field. The up and
  20.      down cursor keys behave a little differently, but experimentation will
  21.      get you used to their actions. The left arrow key will move you to the
  22.      field to the left or the previous field only if the cursor is at the
  23.      leftmost position of the field. The right cursor behaves the same way
  24.      at the rightmost position of the field.
  25.  
  26.      Pressing Escape from the Main Window will bring up the Exit Window. From
  27.      this window, you have the option of saving the configuration and
  28.      exiting, exiting without saving the configuration or cancelling the exit
  29.      and returning to the program.  Pressing ESCape from any of the
  30.      subwindows will return you to the previous window. Changes made to
  31.      fields inside subwindows are "remembered" so ESCape does not abort
  32.      changes made to fields in subwindows, however, the changes made to those
  33.      fields will be lost if you selected Exit - No Save after pressing ESCape
  34.      from the Main Window.
  35.  
  36.      Most of the fields are pretty self-explanatory, but I will elaborate on
  37.      some that might be misconstrued and can cause problems if this happens.
  38.  
  39.      The Path to CONFIG.RA is just that. The drive and directory where your
  40.      CONFIG.RA resides, i.e. your main RA system directory.
  41.  
  42.      The Path to EXITINFO.BBS is where RAMail should look for this file. If
  43.      you are running a single node system, the entry you make here should
  44.      duplicate the Path to CONFIG.RA entry. If you run multiple nodes, this
  45.      should be the path to the particular node directory for which this
  46.      configuration is to be used.
  47.  
  48.      The Path to RAUSER.DAT is where you want RAMail to create and look for
  49.      the RAUSER.DAT data file. This can be anything you want.
  50.  
  51.      The Local Mail Directory is the drive and directory where RAMail should
  52.      place .QWK packets when someone is logged on locally as well as where
  53.      it should look for .REP files when logged on locally. 
  54.  
  55.      The Work Drive is the drive where RAMail will process all QWK and REP 
  56.      packets. RAMail will create temporary work directories on this drive
  57.      when processing mail and will remove them when finished.
  58.  
  59.  
  60.  
  61.      The Required Conferences field allows you to specify which, if any,
  62.      boards should be included in ALL users' mail packets. For example, if you
  63.      want boards 1, 3, and 20 to be included in all user's packets, you would
  64.      enter: 1 3 20 in this field. Leave it blank if you don't want to force
  65.      any boards.
  66.  
  67.      The next five Limit fields allow you to specify the maximum number of 
  68.      messages that RAMail will place into a mail packet for each baud rate.
  69.      The five fields to the right of the message limits are messages limits
  70.      on a Per Conference basis.
  71.  
  72.      The Default File EXT is what most of your downloadable BBS files use an
  73.      extension. For example, if most of your files are compressed with PKZIP,
  74.      the extension would be ZIP. This allows for users to flag files without
  75.      having to specify an extension. This default extension will be used when
  76.      the extension is omitted during flagging.
  77.  
  78.      The Check # of Messages toggle will allow you to tell RAMail whether or
  79.      not it should determine what the highest numbered message is during the
  80.      Conference Selection. If your users get an unusually long WAIT! prompt
  81.      when selecting conferences, you may want to set this toggle to N. NOTE
  82.      that the New User Pointer Subtractor function (below) will not work if 
  83.      you disable this function.
  84.  
  85.      The Put "RAMail" on Tear toggle allows you to control whether "RAMail"    
  86.      will appear on echo message tearlines that are stripped of reader
  87.      taglines. This toggle is only relevant in registered versions of RAMail.
  88.      Unregistered copies of RAMail will always place "RAMail" on stripped
  89.      tearlines.
  90.  
  91.      The New User Pointer Subtractor field allows you to specify a number by
  92.      which a new RAMail user's last read pointers will be adjusted downward 
  93.      from the high message number for the particular board they are selecting.
  94.      For example, if you set this field to 100 and a user selects a message
  95.      board in Conference Select that has a high message number of 1200, their
  96.      last read pointer for that board will be set to 1100. This function ONLY
  97.      operates the first time a user uses RAMail. Setting the subtractor to 0
  98.      disables this function. It is also disabled if you disable the Check # of
  99.      Messages function (see above).
  100.  
  101.      The Board Toggles will allow you to set the Lo Bit, Hi Bit and Tagline
  102.      Stripper toggle and the short name for EACH message board. The Short Name  
  103.      field will be used in the QWK packets generated by RAMail. If you neglect
  104.      to enter a short name, the first 10 characters of your normal board name
  105.      will be used. NOTE that if you change your board name through RACONFIG,
  106.      you must run RAMCONF and change your Short Name as well since the original
  107.      short name would remain and be used erroneously in user packets.
  108.  
  109.      All of the rest of the toggle fields turn off various menu options on the
  110.      RAMail menu.
  111.  
  112.      The Compression Method fields allow you to specify which compression
  113.      programs you want to support when compressing the mail packets. The user
  114.      can pick one of these methods from the RAMail menu. 
  115.  
  116.      The first field, Compression Name, is the descriptive name of the method. 
  117.      Anything is allowable in this field.
  118.  
  119.  
  120.  
  121.      The Compression Program field is where you place the name, with extension,
  122.      of the compression program. The path is not required, but the program
  123.      MUST reside in a directory that is included in your DOS path.
  124.  
  125.      The Decompression Program entry follows the same rules as those of the
  126.      Compression Program entry.
  127.  
  128.      The Compress Command Options allows you to specify command line parameters
  129.      that the compression program will use when compressing files. 
  130.  
  131.      The Decompress Command Options entry follows the same rules as those of
  132.      the Compress Command Options entry.
  133.  
  134.      The Protocols subwindow allows the toggling (on/off) of RAMail's internal 
  135.      protocols as well as maintaining up to 4 external protocols.
  136.      
  137.      -----------------------------------------------------------------------
  138.      NOTE WELL!: The internal protocols used in RAMail have been known to 
  139.      malfunction on some systems. The exact cause of this malfunction is not
  140.      known at this time, but seems to be BIOS related. If you have problems
  141.      with the internal protocols on your system, simply toggle them off and
  142.      use only the external protocols. Hopefully, the cause and solution to
  143.      this problem will be discovered for inclusion in a future version.
  144.      -----------------------------------------------------------------------
  145.      
  146.      The External Protocols subwindow contains fields that you must fill to 
  147.      define your optional external transfer protocols. This will allow you 
  148.      to use any protocols you wish for transferring packets and files in 
  149.      RAMail (including bi-directional protocols) as well as using custom 
  150.      command line parameters for these protocols.
  151.  
  152.      The Protocol Name field is for display purposes. Enter anything you want
  153.      in this field.
  154.  
  155.      The Program Name is the name of the protocol program, with extension. The
  156.      path is not required (nor will it fit!), but the protocol program MUST
  157.      reside in a directory that is listed in your DOS path.
  158.  
  159.      The Send Command String field allows you to enter the command line that
  160.      will be passed to the protocol program. Three macro variables are avail-
  161.      able for you to use. These are #P, which is the COM port number to use,
  162.      #F, which is the file name that will be passed to the protocol, and #S,
  163.      which is the speed (baud rate) that will be passed to the protocol.
  164.  
  165.      The Receive Command String field is for the command line that will be
  166.      passed to the protocol used for receiving files. The same format applies
  167.      as for the Send Command String field.
  168.  
  169.      You can define up to 4 external protocols.
  170.  
  171.      Multi-Node Sysops
  172.      -----------------
  173.      The RA file MESSAGES.RA will be searched for using the RA environment
  174.      variable to locate your CONFIG.RA and read your MsgBasePath info from
  175.      there. You should ALWAYS set this variable. You can also pass the 
  176.      path and name of your MESSAGES.RA file on the command line of RAMCONF, 
  177.      e.g.
  178.  
  179.      RAMCONF RAMAIL.CFG C:\RA\MESSAGES.RA
  180.